home *** CD-ROM | disk | FTP | other *** search
/ PC World 2008 January (DVD) / PCWorld_2008-01_DVD.iso / v cisle / projectx / ProjectX-compiled.exe / ReadMe.txt < prev   
Encoding:
Text File  |  2005-12-17  |  6.3 KB  |  147 lines
  1. /==============================================================================/
  2.  
  3.  ProjectX - a free Java based demux utility
  4.  Copyright (C) 2001-2005 dvb.matt, All Rights Reserved
  5.  
  6.  By the authors, ProjectX is intended for educational purposes only, 
  7.  as a non-commercial test project.
  8.  
  9. /==============================================================================/
  10.  
  11.  This program is free software; you can redistribute it and/or modify 
  12.  it under the terms of the GNU General Public License as published by
  13.  the Free Software Foundation; either version 2 of the License, or
  14.  (at your option) any later version.
  15.  
  16.  This program is distributed in the hope that it will be useful,
  17.  but WITHOUT ANY WARRANTY; without even the implied warranty of
  18.  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19.  GNU General Public License for more details.
  20.  
  21.  You should have received a copy of the GNU General Public License
  22.  along with this program; if not, write to the Free Software
  23.  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  24.  
  25. /==============================================================================/
  26.  
  27.  This program is completely designed as a test, therefore it mostly
  28.  implements its own code instead of a derivation of an ISO reference
  29.  source or any other code. Considerable effort has been expended to
  30.  ensure an useful implementation, even in cases where the standards
  31.  are ambiguous or misleading.
  32.  Do not expect any useful output, even if that may be possible.
  33.  
  34.  For a program compliant to the international standards ISO 11172
  35.  and ISO 13818 it is inevitable to use methods covered by patents
  36.  in various countries. The authors of this program disclaim any
  37.  liability for patent infringement caused by using, modifying or
  38.  redistributing this program.
  39.  
  40. /==============================================================================/
  41.  
  42.  This program includes software developed by the
  43.  Apache Software Foundation (http://www.apache.org/).
  44.  
  45.  This software contains fast high-quality IDCT decoder by Miha Peternel.
  46.  
  47. /==============================================================================/
  48.  
  49.  This program is provided in sourcecode form only,
  50.  because it is meant for educational purposes.
  51.  Binaries of this project itself will not be included (may not apply to external libraries)
  52.  
  53.  If you need an executable, you have to compile the package by yourself,
  54.  or you ask someone to do so for you.
  55.  
  56. /==============================================================================/
  57.  
  58.  For a compilation, you need a Java SDK, which is available for various platforms.
  59.  
  60.  All classes should work at least with Sun's JDK/J2RE 1.2.2 and higher.
  61.  Note: under special circumstances, some graphic drivers/locales cause 
  62.        big troubles with some versions of JRE's on different OS's.
  63.  
  64.  
  65.  Extract all files from the received archive to a separate directory.
  66.  Note:  dependent on the used JDK/JRE, ensure that the directory does not start with a '!'-sign or similars,
  67.         otherwise you'll get an error like 'main class not found'
  68.  
  69.    /**
  70.     * sample of a compilation (may differ on your system) :
  71.     */
  72.    (A) open "build.bat" with an editor and check/correct the entry/path of JAVA_HOME 
  73.        of your installed JDK 
  74.  
  75.    (B) execute the "build.bat" on its place.
  76.        that will compile all sources, 
  77.        build the .jar file and
  78.        copies the resource files from the resource folder into the new .jar,
  79.  
  80.        Notes:
  81.        [i]   now, we made a package for the sources,
  82.              the file sources.lst points to every required sourcefile and its location
  83.        [ii]  the following libraries are required on this place from the V 0.82.0,
  84.              related to the executed .jar:
  85.              - lib/commons-net-1.3.0.jar  (compiled with JDK 1.2.2) *)
  86.              - lib/jakarta-oro-2.0.8.jar  (compiled with JDK 1.2.2) *)
  87.        [iii] the following libraries are optional from the V 0.82.0 :
  88.              - lib/idct*.dll  (win32 optimized lib's for a faster preview)
  89.              copy one of them to the systems folder or where the compiled .jar is located
  90.        [iv]  dependent on the used JDK, you'll encounter some 'warnings' about 'using a deprecated API'
  91.              that's not critical, as long as an actual JDK still supports these methods
  92.  
  93.        *)
  94.        further informations and newer versions (mostly compiled with JDK 1.4.2) you'll find at:
  95.        'jakarta.apache.org/site/binindex.cgi', look for 'Commons Net' and  'ORO'
  96.        - using newer lib's possibly requires an update of the 'build.bat' and 'MANIFEST.MF' !
  97.  
  98.  
  99.    (C) additional received resource files (e.g. other language files) can be added 
  100.        to the .jar file, later, 
  101.        or you put them into the same folder where the compiled .jar is executed.
  102.  
  103.  
  104.    (D) new with version 0.90 and later:
  105.        it is possible to compile and run this program without the gui (means all source files in /gui/..).
  106.        so there is no requirement of running a X server or similars anymore, calling it from the commandline.
  107.  
  108.        if you can't start the non-gui version without a X server, try to call pjx with the 'headless' option
  109.        java -Djava.awt.headless=true -jar ProjectX.jar [options] <file>
  110.        
  111.  
  112.    the compiling process doesn't take more than about 30 seconds.
  113.  
  114.  
  115. /==============================================================================/
  116.  
  117.   the 2 official ProjectX sites:
  118.  
  119.   Project + D/L, only @ sourceforge.net/projects/project-x/
  120.  
  121.   Support for the official version, only @ forum.dvbtechnics.info
  122.  
  123. /==============================================================================/
  124.  
  125.  CREDITS
  126.  
  127.     -  thanx to all the people, who gave hints, files and other things to this project:
  128.  
  129.     dvb.matt - father of Project-X
  130.     Lucike - forum hoster, documentation
  131.     TheHorse - keyboardcontrol of preview
  132.     java.lang - conditional patch of H-resolution
  133.     R-One - DTS support
  134.     ghost - dreambox file segment completion
  135.     roehrist - CVS, X-input
  136.     pstorch - i18n support
  137.     chrisg - Topfield disk access (AddOn)
  138.     jazzydane - danish translation
  139.     Kano / RoEn - Unix buils script
  140.     Eric Albert - BrowserLauncher
  141.     catapult,Bonni - Topfield 5x00 export
  142.     MartinR - Gui-BaseOutputFileName
  143.     ...and all other supporters...
  144.  
  145. /===============================================================================/
  146.  
  147.